home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / keyb / newkey54.zip / README < prev   
Text File  |  1990-10-27  |  17KB  |  428 lines
  1. This contains:
  2.  
  3. - The latest information on changes to Newkey since version 5.0 
  4.  
  5. - Information on how to upgrade version 4.0 macro files to version 5.0 
  6. macro files
  7.  
  8. - Hints on using Newkey functions
  9.  
  10. - The latest information on software and hardware compatibility
  11.  
  12. RECENT CHANGES
  13.  
  14. Version 5.4
  15.  
  16. - A new macro function, {prtscrn}, that will invoke the "print screen" 
  17. function has been added.  Use the macro editor to insert this function.  
  18. Pressing the "print screen" key will NOT cause the {prtscrn} function to 
  19. be inserted in the macro.
  20.  
  21. - Several new macro functions have been added to make it possible to 
  22. test the screen:
  23.  
  24.    {ifescr row,col}TEXT{endife}
  25.  
  26.             - If the contents of the screen starting at row, 
  27.               column equal "TEXT" then execute the macro function 
  28.               immediately following.  "TEXT" can be any characters that can 
  29.               be displayed on the screen.  For example: 
  30.  
  31.                {ifescr 0,75}READY{endife}<go123><nextmac>
  32.  
  33.               Assume the above is in a macro designed to be used by 
  34.               Lotus 1-2-3.  When executed, Newkey would check row 0 
  35.               column 75 of the screen for "READY" and if found, it 
  36.               would execute the <go123> macro, otherwise it would skip 
  37.               the <go123> macro.
  38.  
  39.    {ifnescr row,col}TEXT{endifne}
  40.  
  41.             - If the contents of the screen starting at row, 
  42.               column do not equal "TEXT" then execute the macro function 
  43.               immediately following.  For example:
  44.  
  45.                {ifnescr 0,75}READY{endifne}<go123><nextmac>
  46.  
  47.               Assume the above is in a macro designed to be used by 
  48.               Lotus 1-2-3.  When executed, Newkey would check row 0 
  49.               column 75 of the screen for "READY" and if not found, it 
  50.               would execute the <go123> macro, otherwise it would skip 
  51.               the <go123> macro.
  52.  
  53.    {ifefscr row,col}TEXT{endifef}
  54.  
  55.             - If "TEXT" is found anyplace on the screen execute the macro 
  56.               function immediately following.  For example: 
  57.  
  58.                {ifefscr}READY{endifef}<go123><nextmac>
  59.  
  60.               Assume the above is in a macro designed to be used by Lotus 
  61.               1-2-3.  When executed, Newkey would the full screen for 
  62.               "READY" and if found, it would execute the <go123> macro, 
  63.               otherwise it would skip the <go123> macro.  
  64.  
  65.    {ifnefscr row,col}TEXT{endifne}
  66.  
  67.             - If "TEXT" is not found anyplace on the screen execute the 
  68.               macro function immediately following.  For example: 
  69.  
  70.                {ifnefscr}READY{endifnef}<go123><nextmac>
  71.  
  72.               Assume the above is in a macro designed to be used by 
  73.               Lotus 1-2-3.  When executed, Newkey would check the full 
  74.               screen for "READY" and if not found, it would execute the 
  75.               <go123> macro, otherwise it would skip the <go123> macro.  
  76.  
  77. The if macro functions are probably the most difficult of Newkey's macro 
  78. functions to use.  See EXAMPLE.KEY for some sample if macros that will work 
  79. at the DOS prompt and demonstrate some of the powerful things that can be 
  80. done..
  81.  
  82.    {cancel} - cancel all currently executing macros
  83.  
  84.    {return} - stop executing the current macro and return control to 
  85.               the macro which called the current macro.  If the 
  86.               current macro was not called by another macro then 
  87.               the macro will stop just as if it had terminated 
  88.               normally.
  89.  
  90. The {cancel} and {return} functions have been added to make working 
  91. with the {ifescr} and {ifnescr} functions easier.  The if functions 
  92. can be used to test the currently status of the program and delay 
  93. macro execution until the program is ready to accept further 
  94. keystrokes.  This is more convenient then trying to time how long it 
  95. takes and then using the {wait} function (as long as the program 
  96. displays some sort of indicator on the screen when it is done).  For 
  97. working examples see the macros beginning with "if" in EXAMPLE.KEY.  
  98.  
  99. HINT:  To help determine what row and column a piece of text starts 
  100. on, the "cUt" screen has been changed to display the row and column of 
  101. the current cursor position.  Just pop up the Newkey menu (alt/), 
  102. select "U", move the cursor to the start of the text you want 
  103. to check for, note the row & column, and press ESC to cancel the cut.  
  104. Then use the macro editor to insert the if function.
  105.  
  106. See EXAMPLE.KEY for sample macros illustrating the new functions.
  107.  
  108. Version 5.3
  109.  
  110. - This version more fully uses EMS memory to save you an additional
  111. 15K of memory below the 640K line.
  112.  
  113. - Menu macros have been changed so that they restart themselves after 
  114. the menu option has been selected unless the menu option selected was 
  115. defined with a 'y' in the 'exit' column or the menu's exit key was 
  116. selected.  Previously the menu macro would always end after a menu 
  117. option was selected.
  118.  
  119. Version 5.2 
  120.  
  121. This version sports an updated user interface.  The new interface 
  122. functionally is very similar to earlier versions of 5.0, but with a 
  123. more attractive face.  The menu and display macro edit screens have 
  124. been slightly rearranged.  
  125.  
  126. Version 5.1
  127.  
  128. Newkey will now use EMS memory to store its macro and screen 
  129. buffer.  EMS memory will be automatically used.  To prevent EMS 
  130. usage use the "/noems" parameter when loading Newkey.  For example:
  131.  
  132.   newkey /3000 /noems
  133.  
  134. will load Newkey with a 3000 character macro buffer and prevent 
  135. usage of EMS memory.
  136.  
  137. We have been receiving many requests for a very small version.  We 
  138. have started development of NEWKEYVS for Newkey Very Small.  This 
  139. version does not have the pop-up features and lacks many other 
  140. macro functions.  Currently it requires only about 22k, 38k less 
  141. than the largest version.  Newkeysm is still available, lacks the 
  142. pop-up features, and weighs in at about 35k, 25k less than the 
  143. largest version.
  144.  
  145.                         HINTS
  146.  
  147. HINTS ON EXECUTING MACROS FROM BATCH FILES
  148.  
  149. Macros may be executed from batch files using the "newkeysp /ek=" 
  150. function as described in the Users Guide.  The way this operates can be 
  151. confusing.  Assume that you have a macro defined for <alta>.  To execute 
  152. this macro in a batch file you would place the following statement:
  153.  
  154.       "newkeysp /ek=[alta]" 
  155.  
  156. in the batch file.  This will cause the key code associated with the 
  157. alta key to be inserted in the keyboard buffer.  Now, the next time the 
  158. keyboard buffer is read, alta will be found and the macro associated 
  159. with it executed, just as if you had pressed the alta key yourself.
  160.  
  161. The confusing part of this is that the macro will only execute when the 
  162. keyboard is read, but the keyboard is not read while DOS is processing a 
  163. batch file.  What this means is that the macro will not execute until 
  164. either:
  165.  
  166.      A. control is returned to the DOS command line or 
  167.      B. a program is run in the batch file and the program reads the 
  168.         keyboard.
  169.  
  170. If you wish to execute a macro to drive a program during a batch file 
  171. then you should insert the macro into the buffer and then start the 
  172. program.  For example, to start WordPerfect and execute a macro when 
  173. Wordperfect starts up that will format your letter heading, record a 
  174. macro (lets call it WPSTART) within WordPerfect to create the letter 
  175. heading and place the following two statements in your batch file: 
  176.  
  177.         newkeysp /ek=[wpstart]
  178.         wp
  179.  
  180. Now when the batch file is run, the <wpstart> macro will be inserted 
  181. into the keyboard buffer and when WordPerfect starts it will read the 
  182. keyboard and the <wpstart> macro will execute. 
  183.  
  184. HINTS ON USING MENU MACROS
  185.  
  186. If you wish to do more in a menu macro than allowed by the menu macro 
  187. editor, then define another macro to contain the menu macro and put 
  188. the extra macro functions before and after the invocation of the menu 
  189. macro as desired.  For example:
  190.  
  191. {begdef alta}Extra stuff before<menumac>extra stuff after{enddef}
  192.  
  193. This will allow you to edit the menu macro, <menumac>,